home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_perl.idb / usr / freeware / catman / u_man / cat1 / xsubpp.Z / xsubpp
Encoding:
Text File  |  1998-10-28  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000004444,,,, ppppaaaattttcccchhhh 00004444))))         XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       xsubpp - compiler to convert Perl XS code into C code
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       xxxxssssuuuubbbbpppppppp [----vvvv] [----CCCC++++++++] [----eeeexxxxcccceeeepppptttt] [----ssss ppppaaaatttttttteeeerrrrnnnn] [----pppprrrroooottttoooottttyyyyppppeeeessss]
  13.       [----nnnnoooovvvveeeerrrrssssiiiioooonnnncccchhhheeeecccckkkk] [----nnnnoooolllliiiinnnneeeennnnuuuummmmbbbbeeeerrrrssss] [----ttttyyyyppppeeeemmmmaaaapppp ttttyyyyppppeeeemmmmaaaapppp]
  14.       [----oooobbbbjjjjeeeecccctttt____ccccaaaappppiiii]... file.xs
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       _x_s_u_b_p_p will compile XS code into C code by embedding the
  18.       constructs necessary to let C    functions manipulate Perl
  19.       values and creates the glue necessary    to let Perl access
  20.       those    functions.  The    compiler uses typemaps to determine
  21.       how to map C function    parameters and variables to Perl
  22.       values.
  23.  
  24.       The compiler will search for typemap files called _t_y_p_e_m_a_p.
  25.       It will use the following search path    to find    default
  26.       typemaps, with the rightmost typemap taking precedence.
  27.  
  28.           ../../../typemap:../../typemap:../typemap:typemap
  29.  
  30.  
  31.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  32.       ----CCCC++++++++ Adds ``extern "C"'' to the C code.
  33.  
  34.       ----eeeexxxxcccceeeepppptttt
  35.            Adds exception handling stubs to    the C code.
  36.  
  37.       ----ttttyyyyppppeeeemmmmaaaapppp ttttyyyyppppeeeemmmmaaaapppp
  38.            Indicates that a    user-supplied typemap should take
  39.            precedence over the default typemaps.  This option may
  40.            be used multiple    times, with the    last typemap having
  41.            the highest precedence.
  42.  
  43.       ----vvvv   Prints the _x_s_u_b_p_p version number    to standard output,
  44.            then exits.
  45.  
  46.       ----pppprrrroooottttoooottttyyyyppppeeeessss
  47.            By default _x_s_u_b_p_p will not automatically    generate
  48.            prototype code for all xsubs. This flag will enable
  49.            prototypes.
  50.  
  51.       ----nnnnoooovvvveeeerrrrssssiiiioooonnnncccchhhheeeecccckkkk
  52.            Disables    the run    time test that determines if the
  53.            object file (derived from the .xs file) and the .pm
  54.            files have the same version number.
  55.  
  56.       ----nnnnoooolllliiiinnnneeeennnnuuuummmmbbbbeeeerrrrssss
  57.            Prevents    the inclusion of `#line' directives in the
  58.            output.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 10/23/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))         22223333////JJJJuuuullll////99998888 ((((ppppeeeerrrrllll 5555....000000004444,,,, ppppaaaattttcccchhhh 00004444))))         XXXXSSSSUUUUBBBBPPPPPPPP((((1111))))
  71.  
  72.  
  73.  
  74.       ----oooobbbbjjjjeeeecccctttt____ccccaaaappppiiii
  75.            Compile code as C in a PERL_OBJECT environment.
  76.  
  77.            back
  78.  
  79.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  80.       No environment variables are used.
  81.  
  82.      AAAAUUUUTTTTHHHHOOOORRRR
  83.       Larry    Wall
  84.  
  85.      MMMMOOOODDDDIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN HHHHIIIISSSSTTTTOOOORRRRYYYY
  86.       See the file _c_h_a_n_g_e_s._p_o_d.
  87.  
  88.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.       _p_e_r_l(1), _p_e_r_l_x_s(1), _p_e_r_l_x_s_t_u_t(1)
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 10/23/98)
  130.  
  131.  
  132.  
  133.